package com.chaoxi.picturebackend.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.chaoxi.picturebackend.api.aliyunai.model.Texttoimage.TextToImageCreateRequest;
import com.chaoxi.picturebackend.api.aliyunai.model.Texttoimage.TextToImageResponse;
import com.chaoxi.picturebackend.api.aliyunai.model.expand.CreateOutPaintingTaskResponse;
import com.chaoxi.picturebackend.api.aliyunai.model.expand.CreatePictureOutPaintingTaskRequest;
import com.chaoxi.picturebackend.model.dto.picture.*;
import com.chaoxi.picturebackend.model.entity.Picture;
import com.baomidou.mybatisplus.extension.service.IService;
import com.chaoxi.picturebackend.model.entity.User;
import com.chaoxi.picturebackend.model.vo.PictureVO;

import javax.servlet.http.HttpServletRequest;
import java.util.List;

/**
* @author 朱杰
* @description 针对表【picture(图片)】的数据库操作Service
* @createDate 2025-09-28 09:15:37
*/
public interface PictureService extends IService<Picture> {
    /**
     * 图片上传
     * @param inputSource 图片输入源
     * @param pictureUploadRequest 图片上传请求参数
     * @param loginUser 登录用户
     * @return 图片上传结果
     */
    PictureVO uploadPicture(Object inputSource, PictureUploadRequest pictureUploadRequest, User loginUser);

    /**
     * 获取查询条件
     * @param pictureQueryRequest 查询条件
     * @return 查询条件
     */
    QueryWrapper<Picture> getQueryWrapper(PictureQueryRequest pictureQueryRequest);

    /**
     * 将Picture对象转换为PictureVO对象
     * @param picture 图片实体对象
     * @param request HTTP请求对象，用于获取请求上下文信息
     * @return 转换后的PictureVO对象
     */
    PictureVO getPictureVO(Picture picture, HttpServletRequest request);

    /**
     * 将Page<Picture>分页对象转换为Page<PictureVO>分页对象
     * @param picturePage 图片实体分页对象
     * @param request HTTP请求对象，用于获取请求上下文信息
     * @return 转换后的PictureVO分页对象
     */
    Page<PictureVO> getPictureVOPage(Page<Picture> picturePage, HttpServletRequest request);

    /**
     * 验证图片对象的有效性
     * @param picture 待验证的图片实体对象
     */
    void validPicture(Picture picture);

    /**
     * 下载图片
     * @param pictureId 图片id
     * @return 图片下载地址
     */
    String downloadPicture(String pictureId);
    /**
     * 删除图片
     * @param pictureId 图片id
     * @param loginUser 登录用户
     */
    void deletePicture(long pictureId, User loginUser);

    /**
     * 编辑图片
     * @param pictureEditRequest 图片编辑请求参数
     * @param loginUser 登录用户
     */
    void editPicture(PictureEditRequest pictureEditRequest, User loginUser);

    /**
     * 批量编辑图片
     * @param pictureEditByBatchRequest 图片批量编辑请求参数
     * @param loginUser 登录用户
     */
    void editPictureByBatch(PictureEditByBatchRequest pictureEditByBatchRequest, User loginUser);

    /**
     * 图片审核
     * @param pictureReviewRequest 图片审核请求参数
     */
    void doPictureReview(PictureReviewRequest pictureReviewRequest,User loginUser);

    /**
     * 填充图片审核参数
     * @param picture 图片实体对象
     * @param loginUser 登录用户
     */
    void fillReviewParams(Picture picture, User loginUser);

    /**
     * 将Picture对象中的tags字符串转换为List<String>格式
     * @param picture 图片实体对象
     * @return 处理后的图片实体对象
     */
    Picture convertTagsFormat(Picture picture);

    /**
     * 批量抓取和创建图片
     *
     * @param pictureUploadByBatchRequest
     * @param loginUser
     * @return 成功创建的图片数
     */
    int uploadPictureByBatch(
            PictureUploadByBatchRequest pictureUploadByBatchRequest,
            User loginUser
    );
    /**
     * 清理图片文件
     * @param oldPicture 旧图片对象
     */
    void clearPictureFile(Picture oldPicture);

    /**
     * 检查图片权限
     * @param loginUser 登录用户
     * @param picture 图片对象
     */
    void checkPictureAuth(User loginUser, Picture picture);

    /**
     * 根据颜色搜索图片
     * @param spaceId 空间id
     * @param picColor 图片颜色
     * @param loginUser 登录用户
     * @return 图片列表
     */
    List<PictureVO> searchPictureByColor(Long spaceId, String picColor, User loginUser);

    /**
     * 批量更新所有没有主色调值的图片
     * @return 成功更新的数量
     */
    int batchUpdatePicturesColor();

    /**
     * 创建图片扩图任务
     * @param createPictureOutPaintingTaskRequest 扩图请求参数
     * @param loginUser 登录用户
     * @return 返回的图片扩图任务响应
     */
    CreateOutPaintingTaskResponse createPictureOutPaintingTask(CreatePictureOutPaintingTaskRequest createPictureOutPaintingTaskRequest, User loginUser);
    
    /**
     * 创建文字生成图片任务
     * @param textToImageCreateRequest 文字生成图片请求参数
     * @param loginUser 登录用户
     * @return 返回的图片生成任务响应
     */
    TextToImageResponse createTextToImageTask(TextToImageCreateRequest textToImageCreateRequest, User loginUser);
    
    /**
     * 查询文字生成图片任务状态
     * @param taskId 任务ID
     * @param loginUser 登录用户
     * @return 返回的图片生成任务结果
     */
    TextToImageResponse getTextToImageTask(String taskId, User loginUser);
}